KILLPG
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
BSD 4
NAME
killpg
- send signal to a process group
SYNOPSIS
Fd #include <signal.h>
Ft int
Fn killpg pid_t pgrp int sig
DESCRIPTION
Fn Killpg
sends the signal
Fa sig
to the process group
Fa pgrp .
See
sigaction(2)
for a list of signals.
If
Fa pgrp
is 0,
Fn killpg
sends the signal to the sending process's process group.
The sending process and members of the process group must
have the same effective user ID, or
the sender must be the super-user.
As a single special case the continue signal SIGCONT may be sent
to any process that is a descendant of the current process.
RETURN VALUES
Upon successful completion, a value of 0 is returned. Otherwise,
a value of -1 is returned and the global variable
errno
is set to indicate the error.
ERRORS
Fn Killpg
will fail and no signal will be sent if:
- Bq Er EINVAL
-
Fa Sig
is not a valid signal number.
- Bq Er ESRCH
-
No process can be found in the process group specified by
Fa pgrp .
- Bq Er ESRCH
-
The process group was given as 0
but the sending process does not have a process group.
- Bq Er EPERM
-
The sending process is not the super-user and one or more
of the target processes has an effective user ID different from that
of the sending process.
SEE ALSO
kill(2),
getpgrp(2),
sigaction(2)
HISTORY
The
Fn killpg
function call appeared in
BSD 4.0
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- ERRORS
-
- SEE ALSO
-
- HISTORY
-
This document was created by
man2html,
using the manual pages.
Time: 19:41:57 GMT, December 25, 2022